
    <!DOCTYPE html>
    <html lang="zh-CN">
    <head>
      <meta charset="UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1.0">
      <title>重构 Controller 的 7 个黄金法则 - 学习卡片</title>
      <style>
        body { font-family: sans-serif; background-color: #f0f8ff; color: #333; display: flex; flex-direction: column; align-items: center; padding: 50px 20px; }
        .header h1 { font-size: 32px; }
        .grid-container { display: grid; grid-template-columns: repeat(3, 1fr); gap: 28px; width: 100%; max-width: 1200px; }
        .card-container { perspective: 1200px; cursor: pointer; height: 250px; }
        .card { width: 100%; height: 100%; position: relative; transform-style: preserve-3d; transition: transform 0.7s; border-radius: 16px; box-shadow: 0 4px 16px rgba(0,0,0,0.08); }
        .card-container.flipped .card { transform: rotateY(180deg); }
        .card-face { position: absolute; width: 100%; height: 100%; backface-visibility: hidden; display: flex; flex-direction: column; box-sizing: border-box; border-radius: 16px; background-color: #fff; padding: 24px; }
        .card-back { background-color: #f0fff4; transform: rotateY(180deg); justify-content: space-between; }
        .card-category { font-size: 14px; color: #0052d9; margin-bottom: 8px; font-weight: 500; }
        .card-question { font-size: 20px; font-weight: 500; flex-grow: 1; display: flex; align-items: center; justify-content: center; text-align: center; }
        .card-answer-wrapper { flex-grow: 1; overflow-y: auto; }
        .card-answer { font-size: 15px; line-height: 1.7; }
        .card-footer { font-size: 13px; color: #8a919f; border-top: 1px solid #f0f0f0; padding-top: 16px; margin-top: 16px; }
        .card-source { font-size: 13px; color: #8a919f; border-top: 1px solid #f0f0f0; padding-top: 12px; margin-top: 12px; }
      </style>
    </head>
    <body>
      <div class="header">
        <h1>重构 Controller 的 7 个黄金法则 - 学习卡片</h1>
      </div>
      <div class="grid-container">
        
    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">理论</div>
          <div class="card-question">根据单一职责原则（SRP），Controller 的核心职责应该是什么？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">理论</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">一个 Controller 应该只负责处理 HTTP 请求和响应，而不应该承载业务逻辑。业务逻辑（如数据验证、密码加密、用户创建、邮件发送等）应被提取到 Service 层。</div>
          </div>
          <div class="card-source">来源: 1. Controller 设计的核心原则 - 单一职责原则（SRP）</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">模式</div>
          <div class="card-question">文档中推荐的标准化 API 响应格式是怎样的？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">模式</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">定义一个统一的泛型响应类（如 ApiResponse<T>），包含成功状态（success）、消息（message）、数据（data）和时间戳（timestamp）等字段，以提高 API 的一致性。</div>
          </div>
          <div class="card-source">来源: 2. 代码结构优化策略 - 响应格式标准化</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">如何实现统一的参数验证和异常处理？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">使用注解（如 `@Valid`）在 Controller 方法中触发参数验证，并结合一个使用 `@ControllerAdvice` 注解的全局异常处理类来捕获并处理特定异常，例如 `MethodArgumentNotValidException` 和自定义的 `BusinessException`。</div>
          </div>
          <div class="card-source">来源: 2. 代码结构优化策略 - 参数验证与异常处理</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">机制</div>
          <div class="card-question">为什么应该将业务逻辑从 Controller 提取到 Service 层？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">机制</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">将业务逻辑提取到 Service 层是为了实现职责分离。Controller 保持轻量，专注于处理 HTTP 交互，而 Service 层则封装复杂的业务流程、数据处理和事务管理，使得代码更清晰、易于维护和测试。</div>
          </div>
          <div class="card-source">来源: 3. 业务逻辑分离技巧 - Service 层职责划分</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">特性</div>
          <div class="card-question">事务管理应该在哪一层实现？文档中推荐的方式是什么？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">特性</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">事务管理应该在 Service 层实现。推荐使用 `@Transactional` 注解来声明性地管理事务，确保多个数据库操作作为一个原子单元执行，从而保证数据的一致性。</div>
          </div>
          <div class="card-source">来源: 3. 业务逻辑分离技巧 - 事务管理策略</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">文档中提到了哪两种主要方法来提升 Controller 的响应性能？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">文档中提到了两种主要方法：1. 使用缓存（例如通过 `@Cacheable` 注解）来存储和快速检索频繁访问的数据。2. 使用异步处理（例如通过 `@Async` 注解）来执行耗时操作，避免阻塞主请求线程。</div>
          </div>
          <div class="card-source">来源: 5. 性能优化与缓存 - 响应时间优化</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">规范</div>
          <div class="card-question">文档中针对 Controller、方法和 DTO 提出了哪些命名规范？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">规范</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">1. Controller 类名以 `Controller` 结尾，并使用资源的复数形式（如 `UserController`）。2. 方法名以动词开头，清晰表达其意图（如 `getUserById`）。3. DTO 类名以 `Dto` 结尾，并具有描述性（如 `CreateUserDto`）。</div>
          </div>
          <div class="card-source">来源: 6. 代码规范与文档 - 命名规范制定</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">如何使用 Mockito 为 Controller 编写单元测试？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">使用 `@ExtendWith(MockitoExtension.class)` 运行测试，通过 `@Mock` 注解模拟依赖的 Service，并使用 `@InjectMocks` 将模拟对象注入到被测试的 Controller 中。然后，使用 `when(...).thenReturn(...)` 来定义模拟对象的行为，并断言 Controller 的响应是否符合预期。</div>
          </div>
          <div class="card-source">来源: 4. 测试友好性设计 - 单元测试编写</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">模式</div>
          <div class="card-question">在重构臃肿的 Controller 时，分步骤的重构计划是怎样的？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">模式</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">重构计划分为三个主要步骤：第一步是提取 DTO（数据传输对象）并添加验证规则；第二步是创建专门的 Service 类，将所有业务逻辑从 Controller 迁移过去；第三步是重构 Controller，使其调用新创建的 Service，并处理异常和响应格式化。</div>
          </div>
          <div class="card-source">来源: 7. 重构实战案例 - 重构计划制定</div>
        </div>
      </div>
    </div>

      </div>
    </body>
    </html>
